2017年7月17日之前移植您的View and Data 工程

熟悉Autodesk Forge的朋友可能知道Autodesk 两年前有个名为View and Data的技术，即网页模型浏览和业务拓展。使用中需要进行身份认证（获取token），上传模型，转换成网页浏览格式。以及Viewer的JavaScript包对网页格式进行渲染和加载，拓展。这几步其实后端用到几个云服务端口，形如：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v1/buckets/

• POST https://developer. api.autodesk.com/oss/v1/buckets/:bucketKey/objects/:objectName

• POST https://developer. api.autodesk.com/viewingservice/v1/register/

在去年6月Forge 大会之后，前面的几个服务的功能已变成Forge独立的服务中的一部分：

• 身份认证（authentication）

• 数据管理（Data Management）

• 数据提取和格式转换（Model Derivitives）

例如上面的几个端口新版为：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v2/buckets/

• POST https://developer. api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectName

• POST https://developer.api.autodes...

可以看到数据管理和模型提取服务版本定为v2，所以经常称作v2转换过程。v2不只是端口名字的变化，而是开发者可以单独的调用，获取对应的数据。当然，每种服务体系中的端口也更加丰富，例如身份认证（authentication）可以进行授权认证的过程，让开发者可以访问到最终客户在Autodesk 云产品上的数据存储。数据管理中，可以对原始模型进行获取，删除，转换后的模型删除，而也提供Autodesk 云产品例如Autodesk 360 的Project，Folder，Item等操作。至于数据提取，也可提取出模型的层次结构和对象属性列表等。而且v2的转换服务可以支持转换出更多格式，例如OBJ，STL，IFC，FBX等等。不仅这些，v2的基础安全机构更加的完善和强壮。

同时，网页浏览和业务拓展的JavaScript库也不断升级更新，虽然其版本号体系和后端的Forge云服务不同。而JavaScript也对v2的转换过程产生的数据进行对应的兼容工作，不断提高性能和功能。

从去年6月到现在，v1和v2是并存的状态，客户都可以用，但实际上v1更多处于维护的状态。随着绝大多数客户已经稳定的使用v2，Autodesk Forge团队决定，从今年7月17日起，停止v1的服务。也就是说前面提到的那些云服务端口将终止。而很老的JavaScript库可能也会无法访问。

有些朋友的工程是基于某个时期的样例写的，更多关注前端的应用，而后端可能仍旧用的v1端口。所以，特此通知，务必尽快移植相关工程到v2过程。移植需要做的工作不多：

1. 按帮助文档，用v2的端口替换以前的端口

2. 根据v2的参数说明，调整request和response的细节。例如有些端口的response的json结构变化了

3. 身份认证获取token，务必提供参数scope

4. 链接到较新的Forge Viewer JavaScript库。不指定版本目前默认是2.10. 指定版本，现在最高可以到2.14

5. 调试工程，排查错误

可以直接参考Forge相关的样例调整, 例如，以下博客提到的样例：
https://segmentfault.com/a/11...

如在移植过程中遇到任何问题，请联系Autodesk Forge支持团队。